Skip to main content

Custom Domains

By default, each tunnel gets an assigned FQDN from Cruma.io (for example, <tunnel-id>.tun.cruma.io). You can bring your own domain by creating a CNAME record that points to your tunnel FQDN, then add that hostname to your targets.

Steps

  1. Connect your agent and note the assigned tunnel FQDN (based on your tunnel ID).
  2. In your DNS provider, create a CNAME from your desired hostname (e.g., app.yourdomain.com) to that tunnel FQDN (<tunnel-id>.tun.cruma.io).
  3. Add the custom hostname to the hostnames list for your target (via CLI or config file).

Once DNS propagates, traffic to your custom hostname will route through the tunnel just like the built-in address. For custom hostnames, TLS terminates on your agent; ensure you present a valid certificate there.